Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Types and Constants

Settings Values for Standard Controls

This section lists the initial, minimum, and maximum settings for all standard controls. You should set these values in the control ('CNTL') resource when creating a new control from a resource or pass these values in the minimumValue, maximumValue, and initialValue parameters of NewControl.

Some controls specify other information besides their range in their minimum and maximum settings. For example, bevel buttons use the high byte of their minimum value to indicate their behavior.

Control Values

Push button (pre-Appearance)

Initial: 0
Minimum: 0
Maximum: 1

Push button (Appearance-compliant)

Initial: 0
Minimum: 0
Maximum: 1

Checkbox (pre-Appearance)

Initial: kControlCheckboxUncheckedValue
Minimum: kControlCheckboxUncheckedValue
Maximum kControlCheckboxCheckedValue

Checkbox (Appearance-compliant)

Initial: kControlCheckboxUncheckedValue
Minimum: kControlCheckboxUncheckedValue
Maximum: kControlCheckboxCheckedValue or kControlCheckboxMixedValue

Radio button (pre-Appearance)

Initial: kControlRadioButtonUncheckedValue
Minimum: kControlRadioButtonUncheckedValue
Maximum: kControlRadioButtonCheckedValue

Radio button (Appearance-compliant)

Initial: kControlRadioButtonUncheckedValue
Minimum: kControlRadioButtonUncheckedValue
Maximum: kControlRadioButtonCheckedValue or kControlRadioButtonMixedValue

Scroll bar (pre-Appearance and Appearance-compliant versions)

Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768; when the maximum setting is equal to the minimum setting, the scroll bar is inactive.

Bevel button

Initial: If you wish to attach a menu, the menu ID; if no menu is attached, 0.
Minimum: High byte specifies behavior--see "Bevel Button Behavior Constants". Low byte specifies content type--see "Bevel Button and Image Well Content Type Constants".
Maximum: Resource ID of bevel button's content if resource-based--see "Bevel Button and Image Well Content Type Constants".

Slider

Initial: Appropriate value between -32768 and 32768; for tick mark variant, the number of ticks; reset to the minimum setting after creation.
Minimum: -32768 to 32768
Maximum: -32768 to 32768; when the maximum setting is equal to the minimum setting, the slider is inactive.

Disclosure triangle

Initial: 0 (collapsed) or 1 (expanded)
Minimum: 0 (collapsed)
Maximum: 1 (expanded)

Progress indicator

Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768

Little arrows

Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768

Asynchronous arrows

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Tab control

Initial: Resource ID of the 'tab#' resource you are using to hold tab information. Reset to the minimum setting after creation. Under Appearance 1.0.1 and later, a value of 0 indicates not to read a 'tab#' resource; see "The Tab Information Structure".
Minimum: Ignored. Reset to 1 after creation.
Maximum: Ignored. Reset to the number of individual tabs in the tab control after creation.

Separator line

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Primary group box and secondary group box

Initial: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same value as the checkbox or pop-up button.
Minimum: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same minimum setting as the checkbox or pop-up button.
Maximum: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same maximum setting as the checkbox or pop-up button.

Image well

Initial: If you wish to attach a menu, the menu ID. If no menu is attached, 0. Resource ID of bevel button's content if resource-based--see "Bevel Button and Image Well Content Type Constants". Reset to 0 after creation.
Minimum: High byte specifies behavior--see "Bevel Button Behavior Constants". Low byte specifies content type--see "Bevel Button and Image Well Content Type Constants". After the image well is created, reset to 0.
Maximum: Ignored. Reset to 2 after creation.

Pop-up arrow

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Placard

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Clock

Initial: One or more of the clock value flags--see "Clock Value Flag Constants". Reset to 0 after creation.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

User pane

Initial: One or more of the control feature constants--see "Specifying Which Appearance-Compliant Messages Are Supported". Reset to 0 after creation.
Minimum: Ignored. After user pane creation, reset to a setting between -32768 to 32768.
Maximum: Ignored. Reset to a setting between -32768 to 32768 after creation.

Editable text field

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Static text field

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Picture

Initial: Resource ID of the 'pict' resource you wish to display; reset to 0 after creation.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Icon

Initial: Resource ID of the 'cicn', 'ICON', or icon suite resource you wish to display. For icon suite variant, it only looks for an icon suite. If not, it looks for a 'cicn' or 'ICON' resource. Reset to 0 after creation.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Window header

Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

List box

Initial: Resource ID of the 'ldes' resource you are using to hold list box information; reset to 0 after creation. An initial value of 0 indicates not to read an 'ldes' resource under Appearance 1.0.1 and later.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.

Pop-up menu (pre-Appearance and Appearance-compliant versions)

Initial: One or more of the pop-up menu title constants.
Minimum: Resource ID of the 'MENU' resource.
Maximum: Width (in pixels) of the pop-up menu title.

Radio group

Initial: Set to 0 on creation. Reset to the index of currently selected embedded radio control after creation. If currently selected control does not support radio behavior, value will be set to 0 and the control will be deselected. To deselect all controls, set to 0.
Minimum: Set to 0.
Maximum: Set to 0 on creation. Reset to the number of embedded controls as controls are added.